ATA_Abort

PATH Hardware Documentation > Device Managers and Drivers > ATA Devices > ATA Device Software Guide

ATA_Abort

The ATA_Abort function terminates a specified queued I/O request. This function applies to asynchronous I/O requests only. The ATA_Abort function searches through the I/O queue associated with the selected device and aborts the matching I/O request. The current implementation does not abort if the found request is in progress. If the specified I/O request is not found or has started processing, an ATAUnableToAbort status is returned. If aborted, the ATAReqAborted status is returned.

It is up to the application that called the ATA_Abort function to clean up the aborted request. Clean up includes parameter block deallocation and operating system reporting.

The manager function code for the ATA_Abort function is $10.

The parameter block associated with this function is defined as follows:

`typedef`	`struct`	`/* ATA abort structure */`
{
	`ataPBHdr`		`/* ataPBHdr parameter block */`
	`ataPB*`	`AbortPB;`	`/* Address of the parameter block / / of the function to be aborted */`
	`UInt16`	`Reserved[22];`	`/* Reserved */`
`} ataAbort;`

Field descriptions

ataPBHdr: See the definition of the ataPBHdr parameter block.
AbortPB: This field contains the address of the I/O parameter block to be aborted.
Reserved: This field is reserved. To ensure future compatibility, all reserved fields should be set to 0.

RESULT CODES

See Table A-1 for possible result codes returned by the ATA Manager.

Previous | Back Up One Level | Next | Show Frames | Hide Frames